銀行振込(バーチャル口座)継続口座利用 API一覧

※idPass版にのみ対応しています。json版には対応しておりません。

HTTP仕様(.idPass)

Request header
Content-Type: application/x-www-form-urlencoded;charset=windows-31j
Method
POST
Response header
Content-Type: text/plain;charset=windows-31j
Status Code
200:常に200を返却

AssignVirtualaccount 継続口座登録

入力パラメータで指定した口座IDとして未使用のバーチャル口座を割り当てし、口座情報を返却します。 返却された口座は、継続口座として利用可能です。 口座情報(BankCode,BranchCode,AccountType,AccountNumber)を指定しなかった場合、 お客様が保有するバーチャル口座で未使用な口座を自動的に選択し、継続口座に割り当てします。 口座情報を指定した場合は、指定された口座を継続口座に割り当てします。

リクエスト
ShopID 必須 半角英数13桁
ショップID
ShopPass 必須 半角英数64桁
ショップパスワード
ReserveID 必須 半角英数32桁
継続口座ID

加盟店様が継続口座を識別するためのユニークな値を設定します。

BankCode 半角数字4桁
銀行コード
BranchCode 半角数字3桁
支店コード
AccountType 半角数字1桁 固定
預金種別
AccountNumber 半角数字7桁
口座番号

口座情報(BankCode,BranchCode,AccountType,AccountNumber)を指定しなかった場合、
お客様が保有するバーチャル口座で未使用な口座を自動的に選択し、継続口座に割り当てします。
口座情報を指定した場合は、指定された口座を継続口座に割り当てします。

URL
/payment/AssignVirtualaccount.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&ReserveID=12345
レスポンス
正常
ReserveID 半角英数32桁
継続口座ID
BankCode 半角数字4桁
銀行コード
BankName 全半角30バイト
銀行名
BranchCode 半角数字3桁
支店コード
BranchName 全半角30バイト
支店名
AccountType 半角数字1桁 固定
預金種別
AccountNumber 半角数字7桁
口座番号
異常
ErrCode 半角英数3桁 固定
エラーコード
ErrInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
ReserveID=12345&BankCode=9998&BankName=テスト銀行&BranchCode=999&BranchName=テスト支店&AccountType=1&AccountNumber=1119999
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

FreeVirtualaccount 継続口座解除

入力パラメータで指定した継続口座IDに割り当てられている継続口座を解除します。

リクエスト
ShopID 必須 半角英数13桁
ショップID

ShopPass 必須 半角英数64桁
ショップパスワード

ReserveID 必須 半角英数32桁
継続口座ID

URL
/payment/FreeVirtualaccount.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&ReserveID=12345
レスポンス
正常
ReserveID 半角英数32桁
継続口座ID

BankCode 半角数字4桁
銀行コード
BankName 全半角30桁
銀行名
BranchCode 半角数字3桁
支店コード
BranchName 全半角30桁
支店名
AccountType 半角数字1桁 固定
預金種別
AccountNumber 半角数字7桁
口座番号
異常
ErrCode 半角英数3桁 固定
エラーコード
ErrInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
ReserveID=12345&BankCode=9998&BankName=テスト銀行&BranchCode=999&BranchName=テスト支店&AccountType=1&AccountNumber=1119999
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001